/* @(#) somx/readme 2.3 1/20/94 09:25:08 [5/15/94 17:57:42] */

/*
 * 96F8647, 96F8648, 96F8850 (C) Copyright IBM Corp. 1992, 1994
 * All Rights Reserved
 * Licensed Materials - Property of IBM
 *
 * DISCLAIMER OF WARRANTIES.
 * The following [enclosed] code is sample code created by IBM
 * Corporation. This sample code is not part of any standard or IBM
 * product and is provided to you solely for the purpose of assisting
 * you in the development of your applications.  The code is provided
 * "AS IS". IBM MAKES NO WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT
 * NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
 * FOR A PARTICULAR PURPOSE, REGARDING THE FUNCTION OR PERFORMANCE OF
 * THIS CODE.  IBM shall not be liable for any damages arising out of
 * your use of the sample code, even if they have been advised of the
 * possibility of such damages.
 *
 * DISTRIBUTION.
 * This sample code can be freely distributed, copied, altered, and
 * incorporated into other software, provided that it bears the above
 * Copyright notice and DISCLAIMER intact.
 */


This directory contains the source for a simple generic server which uses
the SOM Object Adapter to automatically load class libraries and execute
requests on objects instantiated in the server.  The server will loop 
forever processing requests from clients.  The directory also contains a
sample client program which uses static bindings to invoke methods on
remote objects.  The client program creates several remote animals, sets
the instance data for the animals, displays the instance data, invokes
other remote methods and destroys the local proxy objects and remote 
animal objects.

NOTE:  Please review the README in %SOMBASE%\samples\somd for general
       information on setting up and running DSOM samples.  This
       README assumes that information.

BUILDING THE SAMPLE
-------------------

The makefile in this directory will build a server executable, a client
executable and a dynamically loadable library.  They are:

 - testsvr.exe (the generic server)

 - danimal.exe (the DSOM client application)

 - danimal.dll (the library loaded by testsvr) 

RUNNING THE SAMPLE
------------------

Remember that the DSOM daemon, "somdd", must be started before executing
the sample.

The server may be started in two ways.  You may start the server yourself
by entering "testsvr -a aniServer" from the command line.  Note that
"aniServer" is the server alias name specified by the makefile when calling
the Implementation Repository registration utility, regimpl.  The other
option is to allow somdd to automatically start the server.  

Simply enter "anitest" from the command line and the results will be
displayed to standard output.
